home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_b / rmdsk2.doc < prev    next >
Text File  |  1995-04-22  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.        5-22-85                        RAMDISK2                     Page 1 
  7.  
  8.        RAMDISK2 configures an ATARI 130XE's  Extra RAM for use with  ATARI DOS  
  9.        2.0S or the OSS DOSXL File Management System. 
  10.         
  11.        The Ramdisk (D4)  created by RAMDISK2  has 503 free  sectors, 4 through  
  12.        359 and 369 through 515. Sectors  360 through 368 contain the VTOC  and  
  13.        Directory as usual. Boot sectors 1  through 3 do not exist, but  a read  
  14.        or  write  attempt  returns  a  'success'  status  code. Any attempt to  
  15.        access sector 516 or higher returns an error 144. 
  16.         
  17.                                     INSTALLATION 
  18.         
  19.        Following  a  power  up  boot,  the  RAMDISK2 object file automatically  
  20.        installs and formats the Ramdisk  when executed as a binary  load file.  
  21.        It  may  alternatively  be  renamed  to  AUTORUN.SYS.  The installation  
  22.        functions are: 
  23.         
  24.        1. Verify that  the DOS File  Management System is  either the standard  
  25.        Version 2 as supplied with ATARI DOS 2.0S and normal OSS DOSXL, or  the  
  26.        modified version from DOSXL.XL. Exit if not. 
  27.         
  28.        2.  Verify  that  the  computer  system  actually has Extra Ram at 4000  
  29.        hexidecimal. Exit if not. 
  30.         
  31.        3. Copy the relocatable driver code to the end of the FMS, and set  the  
  32.        drive bit in DRVBYT for drive 4. 
  33.         
  34.        4. Replace the FMS calls to  SIO and the OS Resident Disk  Handler with  
  35.        calls to the relocated code. 
  36.         
  37.        5.  If  the  FMS  was  the  standard  Version  2,  kill the 'write DOS'  
  38.        function by pointing it to the Invalid Device Command error return. 
  39.         
  40.        6.  Add  the  length  of  the  driver  code  to  SASA, the FMS start of  
  41.        allocation address word. 
  42.         
  43.        7. Reinitialize the FMS. 
  44.         
  45.        8. If the Extra  RAM is not already  formatted as Ramdisk, clear  it to  
  46.        zeroes and write the VTOC for the 503 available sectors. 
  47.         
  48.                                        NOTES: 
  49.         
  50.             Once the installation has been done, rerunning the RAMDISK2 
  51.             code will exit at function 1, thus avoiding multiple copies of 
  52.             the driver code. 
  53.         
  54.             Function 8 allows rebooting the computer by forcing a 
  55.             coldstart. A  reboot without turning off the computer does 
  56.             not destroy the Ramdisk contents. 
  57.         
  58.         
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.        5-22-85                        RAMDISK2                     Page 2 
  73.  
  74.         
  75.                                          USE 
  76.         
  77.        Once RAMDISK2 has set up  D4 in the Extra Ram  it may be used like  any  
  78.        other drive interfaced through DOS. 
  79.         
  80.        The bit map in the VTOC created with the Ramdisk indicates sectors  516  
  81.        through 720 are in use, so the  FMS will not attempt to write to  them.  
  82.        However, if you reformat the  Ramdisk, the driver code merely  corrects  
  83.        the maximum  and free  sector counts  in the  VTOC written  by FMS. The  
  84.        same  logic  applies  to  a  sector  copy  routine  like the the DUPDSK  
  85.        extrinsic command of DOSXL, which directly copies each sector shown  in  
  86.        use by  the bit  map. The  FMS merely  maintains the  sector counts for  
  87.        your convenience, and  actually uses the  bit map for  all decisions on  
  88.        what sectors are available. Therefore this logic allows duplicating  an  
  89.        actual  disk  to  the  Ramdisk  and  back  to disk again, so long as no  
  90.        sector above 515 is in use.  I strongly rcommend, however, that a  COPY  
  91.        with wildcards be used instead, as  that will maintain the bit map  and  
  92.        sector counts together. 
  93.         
  94.         
  95.                                       WARNINGS 
  96.         
  97.        Any program which does not use  the DOS File Management System for  all  
  98.        disk  handling  will  probably  not  work.  For  example,  the DOS 2.0S  
  99.        DUP.SYS has  its own  call to  the OS  Resident Disk  Handler for drive  
  100.        status.  The  other  problem  with  using  DUP.SYS  is that the Ramdisk  
  101.        driver uses 255 of the measly 768 bytes allowed by the system for  VTOC  
  102.        and Sector buffers.  As with the  addition of any  other single density  
  103.        disk, the  FMS allocates  an additional  128 byte  space for  the VTOC.  
  104.        Thus, installation of the Ramdisk increases LOMEM 383 bytes. 
  105.         
  106.        The Ramdisk will obviously be incompatible with any program which  uses  
  107.        the 130XE Extra Ram for other purposes. 
  108.         
  109.        The  modifications  affect  the  FMS  code  which would be written by a  
  110.        'write DOS.SYS' operation. Since the Ramdisk driver code would not  yet  
  111.        be  loaded  when  the  boot  code  attempted  Serial  IO,  a  cold boot  
  112.        operation would  immediately lock  up the  computer. It  would then  be  
  113.        necessary  to  power  down,  thereby  losing  any  information  on  the  
  114.        Ramdisk. The installation code forces  the 'write DOS.SYS' code in  the  
  115.        standard FMS to return an invalid command (168) error code. If you  see  
  116.        it, do not  attempt to boot  from the disk  which was being  written at  
  117.        that time. 
  118.         
  119.         
  120.         
  121.         
  122.         
  123.             Josef W. Segur [74676,3047]   5-25-85 
  124.         
  125.         
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.